home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 5 / Apprentice-Release5.iso / Source Code / C / Applications / MacGzip 1.0 / source / Docs / README (mac sources) < prev   
Text File  |  1995-12-30  |  5KB  |  132 lines

  1. •  MacGzip 1.0 (gzip 1.2.4) -sources-
  2.  
  3. You can build MacGzip 1.0b1 using:
  4.  
  5.  Symantec C 8.0
  6.  MW C 6.1 (with external Rez compiler)
  7.     Note: if you are interested in comipiling the PPC version with Symantec 8.0, drop me a note. (mailto:macspd@ivo.cps.unizar.es)
  8.  
  9. •  About the sources....
  10.  
  11. MacGzip was developed mainly from two sources: gzip 1.2.4 original distribution (by Jean-loup Gailly) and the example source code from Apple's  Developer CD Series. I must mention also Quinn <quinn@cs.uwa.edu.au> (et al) for Internet Config Prog Kit., and Erling Johansen <ejo@vingmed.no>, who made the first PPC porting (0.3b3, b3 and b5)
  12.  
  13. (In MacGzip's readme, you can find a list of involuntary contributions, and also in the source code)
  14.  
  15. Part of the Apple source code comes from Snippets
  16. (Snippets are not tested by anyone, except (presumably) the author. They are NOT to be considered the final or best way to do something. They are just bits of code that the DTS engineers and others come up with and feel might be useful to developers. Think of Snippets as a "Bucket 'o Rusty Parts" that is provided for your browsing pleasure, NOT as polished examples. A Snippet should only be used in a commercial application if YOU are sure that it does what you want. )
  17. so, you can apply this to macgzip sources, too.
  18.  
  19. In earlier versions (specially the ones previous to 0.3), the mac code (and gzip.c) was really bad in some points. I think this time it is better,  but if you want to use somethig as example, check it carefully).
  20.  
  21. In 1.0b0 there are a bunch of stupid (but serious) bugs, I think they all are fixed in this release (who knows?)
  22.  
  23. • The sources
  24.  
  25. 'GNU' folder contains GNU sources and documentation, several files had been modified. If you find some error here, probably is mine.
  26.  
  27. In this release (1.0x) gzip sources were modified in the right way (using the correct #ifdefs, this wasn't true for previous versions), so you can compile the sources in the same machines as original gzip 1.2.4 sources.(I hope)
  28. (choosing the original gzip.c, which I renamed to gzip.c.cln)
  29.  
  30. "#define MACOS" options are generic for every Mac OS (I guess), for MacGzip only options I use "#define MACGZIP" (in the first lines of 'tailor.h').
  31. Note: #define MAXSEG_64K is required by unlzw.c in order to decompress Unix .Z files.
  32.  
  33. Note: In Symantec C, you can't compile gzip using 4 bytes integers; some ANSI functions are implemented in 68K .asm format, and they expect 2 bytes ints.
  34.  
  35. Changes:
  36.  
  37.     -Standard output and error by alerts.
  38.     -Insert here an there System Tasks to be nice with other applications and to update progress bar. (for example one call in the 'fill the input buffer' function)
  39.     -other... (Search MACGZIP || MACOS || spd)
  40.  
  41. Note: Some of the command line options (-vlt) are not available just because they require aditional Macintosh interface; but using Think C console (and the original gzip.c.cln with some little modifications), they should work.
  42.  
  43.  
  44. 'Mac' folder holds some files from Internet Config Programmers Kit, and the sources of the interface; they can be reused with some minor changes for any other file processing (input file + few parameters -> output file).
  45.  
  46. There are several ways in which this source could be improved; here you are some:
  47.  
  48. -MacAE.c:
  49.     High Level Events with aditional parameters
  50.  
  51. -GzErrors.c:
  52.           Draw a color 'rotate' icon (instead of a 'SICN')
  53.  
  54. -Work.c:
  55.     There must be a better way to do this...
  56.  
  57. -PrefsDlg.c:
  58.           Make dialog not modal
  59.  
  60. -MacIO.c: 
  61.           Is a generic library to do transparent IO in ascii/bin/macbinary mode. It has some limitations: It doesn't support O_APPEND, etc...; and the macbinary code does not saves/restores finder comments (I hate Finder Comments, anyway)
  62.  
  63.  
  64. Generic:
  65.         Change all literal strings to resources (very boring work; too many #ifdefs for GNU sources.)
  66.   Use the thread manager instead of such confusing event loop.(?)
  67.  
  68. In 'Resources' you can find some .rsrc files and some .r text files.
  69. Since CW can't compile (Rez) .r files, you will need an external tool to convert them to actual resources (or you can copy the resources from MacGzip application...)
  70.  
  71. • The Song
  72.  
  73.  
  74.         Pide, pídeme la vida
  75.         Pide, pidela una vez
  76.         Mira, mirame despacio
  77.         Deja, déjame caer
  78.         
  79.         Si
  80.             tu noche está vacía,
  81.         pon
  82.             un crimen en tu vida
  83.         Si
  84.             tu copa está vacia,
  85.         pon
  86.             un crimen en tu vida
  87.         
  88.         Pisa, písame la sombra
  89.         Sigue, sígueme hasta ver
  90.         Muerto, matame estoy muerto
  91.         Muerto, me dejo querer
  92.         
  93.         Si
  94.             tu noche está vacía,
  95.         pon
  96.             un crimen en tu vida
  97.         Si
  98.             tu copa está vacia,
  99.         pon
  100.             un crimen en tu vida
  101.  
  102.         Fuera , fuera de peligro
  103.         Dentro, Dentro de la ley
  104.         Muerto, Muerto estoy despierto
  105.         Muerto, soñaré al revés
  106.  
  107.         Si
  108.             tu noche está vacía,
  109.         pon
  110.             un crimen en tu vida
  111.         Si
  112.             tu copa está vacia,
  113.         pon
  114.             un crimen en tu vida
  115.         
  116.         Si tu noche está vacía,
  117.         te dare tu medicina
  118.         Si tu copa está vacía,
  119.         te daré tu medicina
  120.         
  121.         Si tu noche 
  122.         Si tu copa
  123.         Si tu copa
  124.         Si tu noche
  125.         
  126.         Si tu vida es una ruina,
  127.         te daré tu medicina
  128.         Si tu vida es una ruina,
  129.         te daré tu medicina
  130.  
  131.                         Juan Pablo Silvestre (La Boa)
  132.